home *** CD-ROM | disk | FTP | other *** search
/ FishMarket 1.0 / FishMarket v1.0.iso / fishies / 526-550 / disk_528 / fontconv / fc.readme < prev    next >
Text File  |  1992-05-06  |  8KB  |  160 lines
  1.                                    FC
  2.                                 
  3.                                version 1.2
  4.  
  5. What Can This Program do for Me?
  6.         
  7.         This program will convert Macintosh Postscript type 1 and 3 fonts
  8.         to the IBM Postscript type 1 and 3 format and the Macintosh Bitmap
  9.         Screen fonts to the Adobe Binary Format (abf).
  10.         
  11.         Version 2.0 of PageStream can use IBM Postscript type 1 fonts but not
  12.         the type 3 fonts.
  13.         
  14.         Version 2.1 of PageStream can use the .abf's for faster screen
  15.         output yet still use the PostScript fonts for high quality
  16.         printed output. 
  17.         
  18.         
  19. How Do I Use This Program?
  20.  
  21.         Needed before use:
  22.         
  23.         This program needs arp.library 1.3 or greater. A copy of this is
  24.         included. Install the arp.library in your LIBS: directory.
  25.         
  26.         You will need to copy the Macintosh Postscript fonts to the Amiga
  27.         using Mac-2-Dos or any other means that will allow you to copy a
  28.         Macintosh file. The file needs to be copied keeping intact all the
  29.         Macintosh file information (headers and resources) in the same file. 
  30.         This can be done in Mac-2-Dos by specifying the MacBinary Conversion
  31.         method. If the file is transfered in a the SIT format (compressed),
  32.         uncompress the file using the utility UnSit on the Amiga. The UnSit
  33.         program breaks the Mac file into two files (the resource and data fork).
  34.         labeled .R and .D. The font converter cannot use the files if they
  35.         are split like this, so we have provided another utility to rejoin
  36.         the split halves (it also creates a dummy file header). The name of
  37.         this program is MakeMac.
  38.  
  39.         To use these fonts with PageStream v2.0 you will also need to copy the
  40.         corresponding AFM files. Copy these using the ASCII conversion method.
  41.         These files are simple text files.
  42.         
  43.         The best way to use is to have a directory for the Mac fonts and one
  44.         for the converted fonts. For the first font select the FROM file
  45.         and the TO directory (assuming the name is kept the same), Convert
  46.         the file, Select a second FROM file and when you click on the TO 
  47.         gadget the path and name are already set up for you, so simply
  48.         click on the OK gadget of the requester and convert! 
  49.         
  50.         
  51.         To Execute:
  52.         
  53.         This program can be run from either the Workbench or the CLI.
  54.         To run from the Workbench simply double click on the program's icon.
  55.         To run from the CLI all you need to do is to enter FC at the
  56.         CLI prompt and press enter (there are no arguments needed).
  57.         
  58.         
  59.         Interface Description:
  60.         
  61.         Once started a window will open on the Workbench screen that contains
  62.         several gadgets. Working clockwise they are: TO, QUIT, ABOUT, CONVERT,
  63.         and FROM. In the middle of the window are four text boxes. Top to 
  64.         bottom they are as follows: From, To, Status, and a progress gauge.
  65.         Each gadget has a corresponding menu item and a keyboard equivalent.
  66.         
  67.         What do these gadgets do?
  68.         
  69.         FROM: this gadget will put up the ARP file requester so you can 
  70.               select the Macintosh file you wish to convert.
  71.               The directory you select will be retained so the next time
  72.               the requester is put up it will where it was when you left.
  73.  
  74.         TO: this gadget will put up the ARP file requester so you can
  75.             select the destination file (the converted file). The filename
  76.             is preset to the filename from the FROM requester. The directory 
  77.             you select will be retained so the next time the requester is put 
  78.             up it will be in the same directory.
  79.  
  80.         CONVERT: this gadget will be disabled until you select a FROM and TO
  81.                  file unless you have the FROM=TO option set in that case it
  82.                  will be enabled after you select a FROM file. When the gadget
  83.                  becomes enabled it will perform the actual conversion. If the
  84.                  TO file exist a requester will pop up and ask if you want to 
  85.                  replace it or not.
  86.                  
  87.         ABOUT: this gadget will put up an About Box containing exciting 
  88.                copyright information.
  89.                 
  90.         QUIT: this gadget will quit the program. Likewise the close gadget
  91.               on the window will also quit the program.
  92.        
  93.         
  94.         Converting a Macintosh Screen Font:
  95.                                
  96.         If a screen font is selected to convert, when you press the convert
  97.         button the program will scan the file for all the styles contained 
  98.         within. Then a requester will pop up with all the styles presented to 
  99.         you. Initially all the styles are selected. Simply click on the ones 
  100.         you do not want to convert and it will de-select them (or click again 
  101.         to re-select them). As of right now there is no feedback to inform you
  102.         of it's progress as it is converting the screen fonts. When it is done
  103.         the requester will go away and you are brought back to the original
  104.         interface.
  105.  
  106.  
  107.         The Options Menu:
  108.  
  109.         There is a new menu in this release, the Options Menu. There are three
  110.         items on this menu, but only one is available to you. The two that are
  111.         not only work for a particular set of fonts and will currupt "normal" 
  112.         ones. For this reason I have disabled these items. Now about the one 
  113.         that is available to you. This option is the FROM=TO option. If this 
  114.         item is checked, the FROM file name is copied into the TO file name 
  115.         freeing you from having to press the TO button, although the very 
  116.         first time you will need to set the TO directory. but from then on all
  117.         you need to do is press the FROM button and select the FROM file, then
  118.         press the CONVERT button. This can speed up the process if you have a 
  119.         lot of fonts to convert.
  120.  
  121.         
  122.         Known Bugs:
  123.         
  124.         There are a few problems you should know about before you start using 
  125.         the program. First of all the program crashes if it hits a DISK FULL 
  126.         condition when converting a bitmap font to an ABF. Secondly the 
  127.         program creates a zero length file with the same name as the Mac 
  128.         Screen Font file in the destination directory when converting a bitmap
  129.         file to an ABF. This file is of no use and should be removed (unless 
  130.         you really like it).
  131.  
  132.         Those are the only problems we've encountered while using the program.
  133.         As time permits they will be fixed.  
  134.           
  135.         
  136.           
  137. For Your Information:
  138.  
  139.         This program is compatable with Workbench 1.3 and 2.0.
  140.         
  141.         The interface was designed using the following color scheme:
  142.         grey, black, white, and blue.
  143.  
  144.         If you are using Mac-2-Dos, You can tell a type 1 font from a type 3
  145.         by looking at the file size on the Mac disk. If it is 0k then the file
  146.         is a type 1. If it is greater than 1k then the file is usually a type
  147.         3 file.
  148.         
  149.         For those of you familiar with the Mac file format I will explain how 
  150.         the program works. The program searches through the Mac file for the
  151.         POST resources. When found the data they contain is copied to the 
  152.         output file. Type 1 files have all the data contained in the
  153.         resource fork. Type 3 files have the data in the data fork. This
  154.         explains the file size difference.
  155.  
  156.  
  157.         Gary Knight
  158.         Soft-Logik Publishing Corp.
  159.         
  160.